---
title: "웹후크 자동화"
description: "ActivePieces, Zapier, Make.com과 같은 플랫폼을 사용하여 CrewAI AOP 워크플로우를 웹후크로 자동화하세요"
icon: "webhook"
mode: "wide"
---

CrewAI AOP를 사용하면 웹훅을 통해 워크플로우를 자동화할 수 있습니다. 이 문서에서는 웹훅을 설정하고 사용하는 과정을 안내하며, Zapier와 Make.com과 유사한 워크플로우 자동화 플랫폼인 ActivePieces와의 통합에 중점을 두고 crew 실행을 시작하는 방법을 설명합니다.

## Webhook 설정하기

<Steps>
    <Step title="Kickoff 인터페이스 접근">
        - CrewAI AOP 대시보드로 이동하세요.
        - crew 실행을 시작할 때 사용하는 `/kickoff` 섹션을 찾으세요.
            <Frame>
                <img src="/images/enterprise/kickoff-interface.png" alt="Kickoff 인터페이스" />
            </Frame>
    </Step>

    <Step title="JSON Content 구성하기">
        JSON Content 섹션에서 다음 정보를 입력해야 합니다:

        - **inputs**: 다음 항목이 포함된 JSON 객체:
            - `company`: 회사 이름 (예: "tesla")
            - `product_name`: 제품 이름 (예: "crewai")
            - `form_response`: 응답 유형 (예: "financial")
            - `icp_description`: 이상적인 고객 프로필(ICP)에 대한 간략한 설명
            - `product_description`: 제품에 대한 짧은 설명
            - `taskWebhookUrl`, `stepWebhookUrl`, `crewWebhookUrl`: 다양한 webhook 엔드포인트의 URL (ActivePieces, Zapier, Make.com 또는 기타 호환 플랫폼)
    </Step>

    <Step title="ActivePieces와 통합하기">
        이 예시에서는 ActivePieces를 사용합니다. 또한 Zapier, Make.com 등 다른 플랫폼도 사용할 수 있습니다.

        ActivePieces와 통합하려면:

        1. ActivePieces에서 새 flow를 설정하세요.
        2. 트리거를 추가하세요 (예: `Every Day` 스케줄).
            <Frame>
                <img src="/images/enterprise/activepieces-trigger.png" alt="ActivePieces 트리거" />
            </Frame>

        3. HTTP 액션 단계를 추가하세요.
            - 액션을 `Send HTTP request`로 설정하세요.
            - 메소드는 `POST`로 사용하세요.
            - URL은 CrewAI AOP kickoff 엔드포인트로 설정하세요.
            - 필요한 헤더 추가 (예: `Bearer Token`)
                <Frame>
                    <img src="/images/enterprise/activepieces-headers.png" alt="ActivePieces 헤더" />
                </Frame>

            - Body에는 2단계에서 구성한 JSON content를 포함하세요.
                <Frame>
                    <img src="/images/enterprise/activepieces-body.png" alt="ActivePieces 본문" />
                </Frame>

            - crew가 미리 정의된 시간에 kickoff됩니다.
    </Step>

    <Step title="Webhook 설정하기">
        1. ActivePieces에서 새 flow를 만들고 이름을 지정하세요.
            <Frame>
                <img src="/images/enterprise/activepieces-flow.png" alt="ActivePieces Flow" />
            </Frame>

        2. 트리거로 webhook 단계를 추가하세요:
            - 트리거 유형으로 `Catch Webhook`을 선택하세요.
            - 이 작업을 통해 HTTP 요청을 수신하고 flow를 트리거하는 고유 URL이 생성됩니다.
                <Frame>
                    <img src="/images/enterprise/activepieces-webhook.png" alt="ActivePieces Webhook" />
                </Frame>

            - 이메일이 crew webhook 본문 텍스트를 사용하도록 구성하세요.
                <Frame>
                    <img src="/images/enterprise/activepieces-email.png" alt="ActivePieces 이메일" />
                </Frame>
    </Step>
</Steps>

## Webhook 출력 예시

**참고:** kickoff 요청에 제공된 모든 `meta` 객체는 모든 webhook 페이로드에 포함되어, 전체 crew 실행 생명주기에 걸쳐 요청을 추적하고 컨텍스트를 유지할 수 있습니다.

<Tabs>
    <Tab title="Step Webhook">
        `stepWebhookUrl` - 각 agent의 inner thought가 실행될 때마다 호출되는 콜백

        ```json
        {
            "action": "**crewai 엔터프라이즈 솔루션을 위한 금융 산업에 대한 예비 조사 보고서**\n1. 산업 개요 및 동향\n금융 산업은 ....\n결론:\n금융 산업은 디지털 고객 참여, 위험 관리, 규정 준수와 같은 분야에서 crewai와 같은 AI 솔루션을 적용하기에 비옥한 토양을 제공합니다. 고객의 구체적인 요구와 규모에 더 맞춘 crewai 솔루션을 제안하기 위해 리드와의 추가적인 접촉이 추천됩니다.",
            "task_id": "97eba64f-958c-40a0-b61c-625fe635a3c0"
        }
        ```
    </Tab>
    <Tab title="Task Webhook">
        `taskWebhookUrl` - 각 task가 종료될 때마다 호출되는 콜백

        ```json
        {
            "description": "리드의 데이터에서 수집한 정보를 활용해 리드가 속한 산업, 기업 배경, 그리고 crewai의 잠재적 활용 사례에 대해 예비 조사를 수행합니다. 리드 스코어링 및 crewai 피치 전략 수립에 도움이 되는 관련 데이터를 중심으로 조사하세요. 금융 산업은 디지털 고객 참여, 리스크 관리, 규제 준수와 같은 분야에서 crewai와 같은 AI 솔루션을 적용하기에 매우 적합한 환경을 제공합니다. 리드에 맞춤화된 crewai 솔루션을 제안하기 위해 추가적인 접촉을 권장합니다.",
            "task_id": "97eba64f-958c-40a0-b61c-625fe635a3c0"
        }
        ```
    </Tab>
    <Tab title="Crew Webhook">
        `crewWebhookUrl` - crew 실행 종료 시 호출되는 콜백

        ```json
        {
            "task_id": "97eba64f-958c-40a0-b61c-625fe635a3c0",
            "result": {
                "lead_score": "고객 서비스 향상 및 컴플라이언스가 특히 관련성이 높습니다.",
                "talking_points": [
                    "crewai의 AI 솔루션이 자동화된 맞춤형 경험과 24/7 지원으로 고객 서비스를 혁신하고, 고객 만족도와 운영 효율성을 모두 개선할 수 있음을 강조하세요.",
                    "crewai가 더 나은 데이터 분석 및 의사 결정으로 기관의 지속 가능성 목표 달성(책임 투자 및 친환경 이니셔티브 기여)에 도움이 될 수 있음을 논의하세요.",
                    "지속적으로 변화하는 규정에 효율적인 데이터 처리 및 보고 기능으로 crewai가 컴플라이언스 준수를 강화하고, 위반 시 발생할 수 있는 벌금을 줄일 수 있음을 강조하세요.",
                    "crewai의 뛰어난 적응성으로 인해 대규모 다국적 운영뿐 아니라 소규모 맞춤형 프로젝트도 지원하여, 기관의 성장과 함께 솔루션도 확장될 수 있음을 강조하세요."
                ]
            }
        }
        ```
    </Tab>
</Tabs>
